home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / editors / mutt / me2b_pl7.zoo / mu_edit2 / readme < prev    next >
Encoding:
Text File  |  1992-08-26  |  7.4 KB  |  201 lines
  1. -*-text-*-
  2.  
  3. The is the README for ME2.  It contains full source for:
  4.     ME2 (the Mutt Editor v2.3)
  5.     MC2 (the Mutt Compiler v2.1)
  6.     a Compute Server (v1.0)
  7.     various libraries
  8.     Mutt extensions to ME2
  9.  
  10. Released:
  11.   2.0: February 29, 1992 (beta)
  12.   2.2: April 12, 1992 (MS-DOS and OS2 ports, bug fixes)
  13.   2.3  May 10, 1992 (Atari port, minor enhancements)
  14.   2.4: August 9, 1992 (regular expression bug fixes, a PC screen width
  15.        bug fix)
  16.  
  17.  
  18. This release is targeted at Unix, MS-DOS, OS/2 and Atari.  I've tried to
  19. write the code as portablly as possible (in C and ANSI C) so hopefully
  20. it should be "easy" to port to other platforms (that support C).
  21.  
  22. This stuff is released as GNU Ware - use, share and enjoy.
  23.  
  24.  
  25.  
  26.                  What is ME2?
  27.                  ---- -- ----
  28.  
  29.    ME2 is a medium-small, portable, extendable Emacs' like editor that
  30. is known to compile and run on HP-UX (Series 800, 700 and 300), BSD Unix
  31. (Sun, Apollo, DEC, etc), IBM AIX, OSF/POSIX (HP and DEC), MS-DOS/PC-DOS
  32. (IBM PCs and compatibles), OS/2 and Atari (TOS and MiNT).  Standalone,
  33. ME2 is pretty mundane - you need to customize it to make full use of it.
  34. A compiled language is provided for this as well as lots of example
  35. programs:  a C mode, paren matching, a visual towers of hanoi,
  36. incremental searching, programmers calculator, mark rings, multi file
  37. search (and replace) picture mode (from GNU Emacs), gomoku (from GNU
  38. Emacs) and lots more.  Other features include the ability to have
  39. concurrent processes (such as make) running in a buffer (Unix only).
  40.  
  41.  
  42.  
  43.             How to Compile and Install ME2
  44.             --- -- ------- --- ------- ---
  45.  
  46. Compiling
  47. ---------
  48.  
  49. Edit util/os.h so it matches your OS.
  50. Edit mc2/mm.h so that it matches your OS.
  51. Edit me2/config.h so that it matches what you what ME2 to support.
  52. Edit me2/compile so that it matches your OS and config.h.
  53. Edit ./compile for the CFLAGS you want.
  54. Type "./compile" in this directory and it will compile all the
  55.   subdirectories.
  56.  
  57. Notes:
  58.   I've run the compile scripts (and tested the results) on:
  59.       HP-UX 8.0  series 300 (K&R "-O" and Ansi C "-Aa -O")
  60.       HP-UX 7.05 series 300 (K&R "-O")
  61.       HP-UX 7.0  series 800 (K&R "-O" and Ansi C "-Aa -O")
  62.       HP OSF/1 1.0 Operating System A.01.00 ("" - DON'T use -O)
  63.       Apollo 68k SR10.4 BSD (psudeo Ansi C "-O" and Ansi C "-O -Aansi").
  64.     Make sure to set DOMAIN_OS in util/os.h.
  65.     The compiles will complain (lots) about varargs and select.  You
  66.     can ignore these.  I'm pretty sure the varargs complaints are
  67.     groundless.  If you get tired of the messages, you can put
  68.     "-U__STDC__" in the compile flags.
  69.       Sun SparcStation 2, SunOS Release 4.1.1 ("-O")
  70.       IBM RS/6000, AIX Version 3.1 ("-O").  AIX 3.2 ("-O" or ANSI C
  71.     "CC=c89").  Make sure you use -lcurses in me2/compile and set
  72.     AIX_OS in util/os.h.
  73.       DEC 3100 OSF/1 ("-O").  Not much testing done.
  74.       DECstation 5000/200 ULTRIX V4.2 ("-O").  You may need to set
  75.     FOPEN_BINARY (me2/config.h).  On this version of ULTRIX, "rb" is
  76.     OK.
  77.     They should run on other Unix boxes but I can't test everything.
  78.       Let me know if you find problems.
  79.  
  80.   Unixes that kinda work:
  81.     UNIX_System_V 4.1.0 V4ES i386 x86at (a 486 running a SYS V unix).
  82.       To get this to compile:
  83.         - change the #includes of time.h to sys/time.h (./me2/process.c,
  84.       ./me2/unixio.c, ./comserver/comserver.c).
  85.     - in comserver/compile and me2/compile, add "-lsocket -lnsl" to
  86.       the cc line so the socket code will link.
  87.     - or just turn off the compute server (in me2/config.h) and
  88.       don't worry about the socket code.  See why below.
  89.       Problem areas:
  90.         - getcwd() (called from util/canonize.c) gets an access error.
  91.       Maybe its the way my system is set up.  To get around this,
  92.       you have to run me2 setuid root.  Not a very good idea.
  93.     - Some of the termcaps don't seem right.  Use a "xterm" TERM var
  94.       for xterms, "vt100" doesn't work.
  95.     - The compute server doesn't work very well with SYS V signals -
  96.       ME2 will get a signal (from the compute server) while signals
  97.       turned off and dump (not a problem with BSD like signals).
  98.       Maybe linking in /usr/ucblib/libucb.a would work (BSD
  99.       signals).  Nope - seemed to fix the signal problem but broke
  100.       the LED lib and filename completion.  I really shouldn't use
  101.       signals for interprocess communication.
  102.  
  103.   Unixes not supported:
  104.     Apollo SysV (probably any "real" Sys V Unix)
  105.       Sockets are not supported so you need to turn off the compute
  106.         server (in config.h) and don't compile the comserver directory.
  107.       unixio.c has compile problems:
  108.         Change #include <time.h> to <sys/time.h> (why?).
  109.         termio.h doesn't seem to be supported so try USE_BSDIO.
  110.     select() needs to be updated to use the "new" structures.  I
  111.       would do this but its yet another #ifdef and I'm getting tired
  112.       of them.
  113.       Other than that, the other directories seem to compile and work.
  114.       Your best bet is just to compile under BSD.
  115.       If you fix this stuff, send the the changes so I can add them to
  116.         my copies.
  117.       
  118.  
  119.   MS-DOS:
  120.     The compile scripts won't run but should give you an idea of what
  121.       needs to be done.  See below.
  122.  
  123.     John Burnell has ported ME2 to PC-DOS:
  124.       Compiler: JPI Topspeed C  ("__TSC__").
  125.       ME2:
  126.     Use the large memory model (1 meg code and data).  Remember to
  127.       compile the libraries that way also.
  128.     Use FASTVIDEO (me2/config.h)
  129.     Build files (see me2/compile):
  130.       terminal=
  131.       termlib=
  132.       io=misc/pcio.c
  133.       keymap=misc/pckmap.c
  134.       fileio=fileio.c
  135.       process=
  136.       fastvideo=misc/pcfv.c
  137.       spam =
  138.       The util directory:
  139.     fxpand.c uses some Lattice C calls that may not be in other
  140.       Cs.  If this is the case for your compiler, check out
  141.       util/misc/ibmdir.c and util/misc/ibmdir.h to see if they
  142.       will work.  If so, move all files in  misc/ to util/ and add
  143.       them to the utils library.
  144.       Other programs:
  145.     The other programs can use the small code, large data model.
  146.     The compute server is not supported.
  147.  
  148.   OS/2 (port by John Burnell):
  149.     Compiler: JPI Topspeed C  ("__TSC__").
  150.     OS/2 1.3 on a FAT drive, not sure whether it will support HPSF
  151.       filenames (probably not since it uses the MSDOS code to parse
  152.       filenames, although it may cope with long filenames).  Certainly
  153.       it does nothing with EAs at present.
  154.     To compile it, configure the system for MSDOZ (util/os.h), except
  155.       replace the DOS files with the corresponding OS/2 ones viz:
  156.     ./util        replace ibmdir.c with os2dir.c
  157.     ./me2/misc    replace pcfile.c with os2filio.c
  158.             replace pcio.c with os2io.c
  159.             don't use pcfv.c
  160.  
  161.  
  162.   Atari ST TOS and MiNT (port and Makefiles by Jwahar R. Bammi):
  163.     Read ./Makefile for more info.
  164.  
  165.  
  166.   I'd like to keep a list of systems that have compiled and run ME2 and
  167.     those systems that don't.  Please send me info if your system is not
  168.     listed.  Also send bug reports/fixes.
  169.  
  170.  
  171. Installing
  172. ----------
  173.  
  174. Use the install script (as root) or:
  175. Copy me2/me2 and mc2/mc2 to /usr/local/bin or to a directory in your
  176.   PATH.
  177. Copy mutt2/*.mco to /usr/local/lib/me2 or where you specified in
  178.   config.h.  Or leave them where they are and use the ME2 environment
  179.   variable (which is what I do).  See "load" in me2/doc/me2.doc for more
  180.   about this var.
  181.  
  182. As a quick test, run me2, hit Escape x load <return> ganoi <return> and
  183. use 4 disks.  If you get the towers of hanoi, things are probably
  184. working pretty good.
  185.  
  186. Read all the documentation (see ./contents for a list).
  187.  
  188.  
  189.  
  190. Customizing
  191. -----------
  192.  
  193. Read the "Customizing me2.mut" section in me2/doc/package.doc.
  194.  
  195.  
  196. Author
  197. ------
  198. Craig Durland       (503) 750-3354
  199. 3419 SW Knollbrook, Corvallis, OR 97333
  200. craig@cv.hp.com
  201.